package com.jingdianjichi.club.gateway.redis;

import com.fasterxml.jackson.annotation.JsonAutoDetect;
import com.fasterxml.jackson.annotation.JsonTypeInfo;
import com.fasterxml.jackson.annotation.PropertyAccessor;
import com.fasterxml.jackson.databind.DeserializationFeature;
import com.fasterxml.jackson.databind.ObjectMapper;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.data.redis.connection.RedisConnectionFactory;
import org.springframework.data.redis.core.RedisTemplate;
import org.springframework.data.redis.serializer.Jackson2JsonRedisSerializer;
import org.springframework.data.redis.serializer.StringRedisSerializer;

/**
 * Redis配置类
 * 用于配置RedisTemplate，实现Redis数据的序列化和反序列化
 * 主要用于Sa-Token的分布式会话存储和权限缓存
 */
@Configuration
public class RedisConfig {

    /**
     * 配置RedisTemplate Bean
     * 设置Redis的key和value的序列化方式，确保数据能够正确存储和读取
     * 
     * @param redisConnectionFactory Redis连接工厂，由Spring Boot自动注入
     * @return 配置好的RedisTemplate实例
     */
    @Bean
    public RedisTemplate<String,Object> redisTemplate(RedisConnectionFactory redisConnectionFactory) {
        // 创建RedisTemplate实例，指定key为String类型，value为Object类型
        RedisTemplate<String, Object> redisTemplate = new RedisTemplate<>();
        // 设置Redis连接工厂
        redisTemplate.setConnectionFactory(redisConnectionFactory);
        // 创建字符串序列化器，用于key的序列化
        StringRedisSerializer redisSerializer = new StringRedisSerializer();
        // 设置普通key的序列化方式为字符串序列化
        redisTemplate.setKeySerializer(redisSerializer);
        // 设置Hash类型key的序列化方式为字符串序列化
        redisTemplate.setHashKeySerializer(redisSerializer);
        // 设置普通value的序列化方式为JSON序列化
        redisTemplate.setValueSerializer(jackson2JsonRedisSerializer());
        // 设置Hash类型value的序列化方式为JSON序列化
        redisTemplate.setHashValueSerializer(jackson2JsonRedisSerializer());
        
        return redisTemplate;
    }

    /**
     * 创建Jackson2JsonRedisSerializer序列化器
     * 用于将Java对象序列化为JSON格式存储到Redis中
     * 配置ObjectMapper以支持复杂对象的序列化和反序列化
     * 
     * @return 配置好的Jackson2JsonRedisSerializer实例
     */
    private Jackson2JsonRedisSerializer<Object> jackson2JsonRedisSerializer() {
        // 创建Jackson2JsonRedisSerializer实例，指定序列化的目标类型为Object
        Jackson2JsonRedisSerializer<Object> jackson2JsonRedisSerializer =
                new Jackson2JsonRedisSerializer<>(Object.class);
        // 创建ObjectMapper实例，用于JSON序列化配置
        ObjectMapper objectMapper = new ObjectMapper();
        // 设置所有字段的可见性为ANY，包括private字段也能被序列化
        objectMapper.setVisibility(PropertyAccessor.ALL, JsonAutoDetect.Visibility.ANY);
        // 配置反序列化时忽略未知属性，避免因为类结构变化导致的反序列化失败
        objectMapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);
        // 启用默认类型信息，在JSON中包含类型信息，确保反序列化时能正确还原对象类型
        // 这对于存储Sa-Token的会话信息和权限对象非常重要
        objectMapper.enableDefaultTyping(ObjectMapper.DefaultTyping.NON_FINAL, JsonTypeInfo.As.PROPERTY);
        // 将配置好的ObjectMapper设置到序列化器中
        jackson2JsonRedisSerializer.setObjectMapper(objectMapper);
        return jackson2JsonRedisSerializer;
    }
}
